GET_BYTE_REF block

Short summary

Name	GET_BYTE_REF
→POU type	→function
Category	IEC-block, MemoryEnh
Conform to →IEC-standard	not defined in IEC-standard
Graphical interface
Available since	version 1.41.0 (for Neuron Power Engineer) – initial variant version 2.0.9 (for library `Standard`) – graphical interface with in-out variable

The block returns a →reference to the first byte of the element connected to input IN.

	Identifier	→Data type	Description
In-outs (VAR_IN_OUT)	`IN`	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT`, `LINT`, `TIME`, `BOOL`, `BYTE`, `WORD`, `DWORD`, `LWORD`, `STRING`, `CHAR`, `DATE_AND_TIME`, `DATE`, `TIME_OF_DAY` , a →user-defined data type or a →function block Restriction: In case of →array data types, only one-dimensional arrays are allowed.	input value
Return value:	–	`REF_TO BYTE`	reference to the first byte of the input value

Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

See:

"Blocks for safe logic" whether this block is supported for developing safety-relevant applications.
"Highlighting safe logic in the FBD-editor" for the effects when using the block as a block for safe logic.

Usage example of the GET_BYTE_REF block

Usage example of the GET_BYTE_REF block
`FUNCTION_BLOCK ExampleGetByteRef` `VAR` `result : REF_TO BYTE;` `arrayVar : ARRAY [1..10] OF UINT := [10(16#BEEF)];` `END_VAR` `result := GET_BYTE_REF(IN := arrayVar); /* 'result' contains the reference to the first byte of 'arrayVar' */` `ENO := result^ = 16#EF;` `END_FUNCTION_BLOCK`

FUNCTION_BLOCK ExampleGetByteRef

VAR

        result : REF_TO BYTE;

        arrayVar : ARRAY [1..10] OF UINT := [10(16#BEEF)];

    END_VAR

    result := GET_BYTE_REF(IN := arrayVar); /* 'result' contains the reference to the first byte of 'arrayVar' */

    ENO := result^ = 16#EF;

END_FUNCTION_BLOCK

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.